本章介绍如何在 GitLab 中规范地使用议题(Issue)进行任务、需求和缺陷的管理,确保团队协作流程统一、高效。
GitLab 的议题(Issue)用于记录与项目相关的工作事项,例如功能需求、BUG修复、技术任务等。每个 Issue 可以指派负责人、设置优先级、标签、里程碑,并与代码变更(MR)关联,形成闭环。
议题应按类型划分,命名应清晰明确,便于识别:
| 类型 | 前缀示例 | 命名示例 |
|---|---|---|
| 需求类 | [Feature] |
[Feature] 用户注册页面改版 |
| 缺陷类 | [Defect] |
[Defect] 登录接口报500错误 |
在创建议题时,需选择对应模板进行填写:

议题的处理应遵循以下状态流转流程:
graph LR A[待处理] --> B[开发中] B --> C[待测试] C --> D[已关闭]
建议使用标签标识状态变化,例如:
status:pendingstatus:in-devstatus:ready-for-teststatus:closed
开发者或负责人应在每个阶段及时更新状态。在 MR 描述中添加如下语句可实现自动关闭 Issue:
Closes #123
Fixes #456
Resolves #789

议题应设置以下元素以便分类与追踪:
标签(Label):指定类型、状态、模块、优先级等。这里只展示此功能,具体方案需后续统一讨论一起定夺
例如:status:in-dev
里程碑(Milestone):绑定需求或缺陷所属的里程碑

这里只展示此功能,具体方案需后续统一讨论一起定夺
需求标题:
需求背景
需求目标
功能设计文档
实现要点
验收标准
计划上线版本

问题标题
问题描述
问题日志
根因分析
修改方案
验收用例
补救措施
